--------------------------------------------------------------------------------
README.txt for: TWIN BIRTHS AND MATERNAL CONDITION 
By: Sonia Bhalotra and Damian Clarke
Questions: damian.clarke@usach.cl

yyyy-mm-dd: 201606-23
v1.00
--------------------------------------------------------------------------------

This folder contains all publicly available data and all source code used to gen
erate tables and results for the paper "Twin Births and Maternal Condition".  To
fully replicate results in the paper, the following files should be used (all lo
cated in the source folder):

(a) World.do
    > Runs regressions for panels A, D and E of table 1
    > Runs regressions for panels A, D and E of Extended tables E2 and E3
    > Creates figure 1
    > Creates Extended figure E1
    > Creates Extended table E4
    > Creates Extended table E5
    > Exports summary statistics for panels A, D and E of Extended table E1
    > Plots panel A of Extended figure E2

(b) fetalDeaths.do
    > Creates figure 3
    > Creates Extended figures E3 and E4

(c) ALSPAC.do [REQUIRES PRIOR REQUEST OF DATA FROM ALSPAC]
    > Runs regressions for panel C of table 1
    > Runs regressions for panel C of Extended tables E2 and E3
    > Exports summary statistics for panel C of Extended table E1
    
(d) Sweden.do [REQUIRES PRIOR REQUEST OF DATA FROM SWEDISH MEDICAL REGISTRY]
    > Runs regressions for panel B of table 1
    > Runs regressions for panel B of Extended tables E2 and E3
    > Exports summary statistics for panel B of Extended table E1

(e) formatPlots.py
    > Takes results output from World.do and plots Figure 2
    > Takes results from World.do and plots panel B of Extended figure E2
    
(f) formatTables.py
    > Formats tables as displayed in table using results from above files
    > Creates table 1, and Extended tables E1, E2, E3 and E5

Of the files described above, files (a)-(d) should be run with Stata.  Any versi
on later than Stata 11 can be used.  For files (e) and (f) Python should be used
(any release in 2.x.x should be used). File (e) requires that the matplotlib and
numpy libraries are available.
